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Chapter 1 

C/64000 COMPILER 6809 



INTRODUCTION 



This compiler supplement is an extension of the C/64000 Compiler Reference Manual. It contains 
all the processor-dependent compiler information for use with the 6809 microprocessor. 

Descriptions of compiler features, options, and their use are supplied. A detailed discussion of the 
run-time libraries required by the 6809 code generator is included. In addition, a brief discussion 
of the features, capabilities, and limitations of C program development using the emulator is 
provided. 



C PROGRAM DESIGN 



C programs should be designed to be as processor and implementation independent as possible, 
yet certain concessions must be made when the processor has unique characteristics. Programs 
written to run on a large mainframe computer with megabytes of virtual memory may not run on a 
6809 with a maximum of 64k-bytes of addressable memory. Most large mainframe computer im- 
plementations have enough memory to allocate a stack area and a heap for dynamic memory al- 
location with no prompting by the user. In a limited memory system these factors must be com- 
municated to the compiler in some manner. For the 6809, the user must specify the location of 
the stack and, if needed, the location of a memory pool for dynamic allocation routines. The fol- 
lowing sections describe subjects related to programming and compiling C/64000 for the 6809 
processor. 
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HOW TO IMPLEMENT A PROGRAM 

The usual process of software generation is as follows: 

a. Create a source program file using the editor. 

b. Compile the source program. 

c. Link the relocatable files. 

d. Emulate the absolute file. 

e. Debug as necessary. 

This chapter will provide insight into each of these processes. 

The Source File 

The C/64000 compiler takes as input a program source file created with the editor. The basic form 
of a source file is: 

"C" 

"6809" 

/* C functions */ 

f unct 1 onname (argument List, if any) 
argument declarations, if any 

<: 

declarations 
statements 

> 

/*C PROGRAM */ 

main (argument list, if any) 

main argument declarations, if any 

<: 

main declarations 
main statements 

> 
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When source file editing is complete, it is ready for compilation. Notice that the first line of source 
code contains the special compiler directive "C". This informs the compiler to use the C language 
subsystem. The second line contains the special compiler directive "6809". This directive informs 
the compiler to generate relocatable code for the 6809 microprocessor. 

The C/64000 compiler can use either all upper-case characters for keywords or all lower-case 
characters for keywords. The option $UPPER KEYS OFF$ (default condition) allows lower-case 
keywords to be recognized. 

The compiler may produce up to four files as output: a relocatable file, a listing file (if specified), an 
assembly file (if specified), and an assembly symbol file (if specified). Descriptions of these files are 
as follows: 

Relocatable file: If no errors were detected in the source file (called 

FILENAME:source), a relocatable file (called FILENAME:reloc) 
will be created. This file will be used by the linker to create an 
executable absolute file. 

If a listfile is specified when the compiler is evoked, a file con- 
taining source lines with line numbers, program counter, level 
numbers, errors and expanded code (if specified) will be 
generated. 

If assembly file is specified by the option $ASM_FILE$ anywhere 
in the source file, an assembly file, ASM6809, will be created in 
the current userid. This file will contain the assembly language 
source equivalent of the C program being compiled with the C 
language source intermixed as comments. This file may be as- 
sembled by the assembler. 

Assembler symbol file: This file is created unless the option $ASMB_SYM$ is disabled 

within the source program. An assembler symbol file (called 
<FILE_name>:asmb sym) contains the symbolic information 
useful for program debugging during emulation. 



Listing file: 



Assembly file: 
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Linking 



After all program modules have been compiled (or assembled), the modules may be linked to form 
an executable absolute file. The compiler generates calls to a set of library routines for commonly 
used operations such as multiply, divide, comparisons, array referencing, etc. These routines must 
be linked with the program modules. There are three standard libraries which may be used to 
supply these operations. In addition, if real number arithmetic is used, one of the two real number 
libraries must also be linked. 

The first is a debug library file called DLIB 6809:C6809. This library of relocatable procedures con- 
tains some extra code to detect errors such as division by 0, or overflow on multiplication. 

The second library is called LIB 6809:C6809. This library, which has only a limited set of error- 
detection code, should execute slightly faster and take up less space in memory. This library may 
be linked in place of the debug library after reasonable assurance that the code is error free. 



Linking with Real Numbers 



When using real numbers for the 6809, the user must link with the real number support library. 
RealLIB:C6809. 

The library, RealLIB:C6809, supports the C/64000 implementation of the IEEE real number stan- 
dard for both long and short floating point numbers (C data types "double" and "float"). To allow 
for mixed "float" and "double" expressions, all internal real operations are performed using an up- 
acked real number format using a 64-bit mantissa (fraction), a separate sign bit, and a 16-bit sign- 
ed exponent. 

Both real number libraries will load subroutines in the PROG relocatable area. These libraries use 
the DATA relocatable area only for two reasons: a default stack area and a message buffer for error 
detection. 

If the user does not supply his/her own versions of the real error reporting routines, INVALID and 
OVERFLOW, the real library will supply them and a DATA relocatable buffer area for reporting the 
error condition. See the section on real number libraries in Chapter 4 for more information on real 
number error detection. 
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The linker is evoked and the questions asked should be answered as follows: 
link ... 

Object files: M0DULE1 ,M0DULE2 
Library files: DLIB_6809:C6809 



Absolute file name: PROGRAM 



In the link listfile, the library routines that are referenced by the compiled code are linked at the 
end of the last user relocatable PROG and/or DATA areas. This fact must be considered for the 
proper choice of the stack pointer location, and PROG and DATA link addresses. 



Emulation of C Programs 



After all modules have been compiled (or assembled) and linked, the absolute file may be executed 
using the emulation facilities of the Model 64000. The emulator is initialized with the memory 
mapped in keeping with the target system and the stack pointer initialization in the code. 

A program which is designed to run in read-only memory (ROM) should have been compiled with 
the $SEPARATE$ option. The memory should be mapped to have ROM and RAM as illustrated 
below. 



ROM 
prog 



RAM 
data area 

END_DATA_ 

heap 



stack 

STACK 
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For a program that is designed to run completely in random access memory (RAM), the memory 
mapping should look like the following: 



RAM 

prog and data 

END DATA 



heap 



stack 

STACK 



If a transfer address was defined in the linking process, the emulation subsystem will remember 
the transfer address from the absolute file. The emulator will start execution of the program with 
the simple command: 



run 

or 

step 



If the program absolute file does not contain a transfer address these commands will start execu- 
tion at address OOOOH. The user must initialize the stack pointer register to his stack area before 
any program using subroutine calls is executed. 

For C programs, stack initialization is done by the library routine "entry" or "ENTRY". (See Chapter 
2 for additional run-time stack information). If the options $ENTRY ON, UPPER_KEYS OFF$ are 
used in the module defining the C function "main", the library will supply the routine "entry" which 
will initialize the stack and call the user routine "main". In this case, program execution in emula- 
tion should be performed using the command: 



run from Entry 
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If the options $ENTRY ON, UPPER_KEYS ON$ are used in the module defining the C function 
"MAIN", the library will supply the routine "ENTRY" which will initialize the stack and call the user 
routine "MAIN". In this case, program execution In emulation should be performed using the 
command: 



run from ENTRY 



If the program runs to completion, the 6809 will remain in a loop at Z_END_PROGRAM: 



Z END PROGRAM BRA Z END PROGRAM 



NOTE 

It is important to remember that during emulation of C/64000 programs, 
a C compiler program may be debugged symbolically (using global sym- 
bols in the source program) or by source program line numbers of the 
form: #1 . This is a feature that provides a powerful tool for emulation. 



Debugging with DLIB 6809:C6809 Library 



When initializing the emulator, it is a good idea to answer yes to the "stop processor on illegal op- 
code?" question since execution errors may result in a jump into the error handler file, 

Derrors:C6809. 

If, while watching the execution of the code, the status line should indicate "illegal opcode ex- 
ecuted at address XXXXH", note the address and enter the command: 



display local symbols in Derrors:C6809 
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The list will roll off the screen; do not stop it with the reset key, since the information which rolls 
off is not important. When the list has stopped, scan the upper portion of the list for the address at 
which the illegal opcode occurred. The error type will be listed at the left of this address. 
(Descriptions of run time errors are given in Appendix A.) The list will also be generated when 
using library LIB_6809:C6809 by entering the following command: 



display local symbols in Zerrors:C6809 



The display will now appear as follows: 



NOTE 

The addresses will change depending upon the link. 





Label 


Address 


Data 




z 


END PROGRAM 


1242H 


C3H ' 




z" 


'ERR RANGE 


1270H 


22H 


Scan this portion for 


1 


~ERR CASE 


1258H 


08H 


where the illegal 


1 


"ERR DIV BY 0 


124AH 


08H 


opcode occurred. The 


I 


'ERR HEAP 


1268H 


08H 


' data field in this 


T 


"ERR OVERFLOW 


123CH 


08H 


portion is not 


T 


"ERR SET CONV 


1251H 


08H 


significant. 


T 


'ERR UNDERFLOW 


1243H 


08H 


1 


"ERR"STRING 


1235H 


OGH . 




1 


'CC FLAGS 


1296H 


89H 




1 


ACC A 


1297H 


8FH 


The data field in 


T 


ACC B 


1299H 


F6H 


portion may contain 


1 


"REG X 


1298H 


F5H 


• information. The 


1 


'REG U 


129BH 


FOH 


addresses in this 


1 


'CALLER H 


1295H 


69H 


portion are not 


1 


"CALLER L 


1294H 


AOH . 


significant. 



Some of the errors will load locations with register and stack information. 



NOTE 

This compiler can generate duplicate symbols in the assembler symbol file for legal C 
programs. These symbols can be generated by function names that conflict with 
labels generated by the compiler, i.e. E, R, C, and D function labels. Refer to the C 
Compiler Reference Manual for a description of these labels. 

These duplicate symbols can cause ambiguities with some HP 64000 logic analyzer 
measurements since a reference to a duplicated label may produce an incorrect 
result. 
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The compiler produces a warning message whenever it generates a duplicate label to 
warn the user that the use of that symbol in an analysis product may result in an 
incorrect address being traced. This potential problem can be solved by changing 
one of the duplicate function names, or by moving one of the functions to another file. 

Example Warnings: 

*****WARNING ?? - Symbol: Y, is duplicated in the asmb_sym file. 
*****WARNING ?? - Symbol: RY, is duplicated in the asmb_sym file. 
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NOTES 
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Chapter 2 



C/64000 PROGRAMMING 

6809 

PROGRAMMING CONSIDERATIONS 



Introduction 



This chapter covers some important requirements of the run-time 
environment for 6809 C/64000 programs. Although some 
requirements may not be necessary for every program, the 
programmer should become familiar with the information supplied 
in order to use it when the structure of a 6809 program requires 
it. 



Direct Addressing Mode 



The 6809 direct page register (DP) is concatenated with any 6809 
direct access address to generate the complete run-time address 
of an object. For example, if the instruction 

LDA <25H 

is generated as a direct addressing instruction, the object that will be loaded into register A will be 
found at address 25H if the direct page register contents equal OOH. If the direct page register con- 
tents equal OFEH, for example, then the object that will be loaded into register A will be found at 
address 0FE25H. 

The DP register will be initialized to OOH by a 6809 Restart Interrupt. It will never be modified by 
the 6809 compiler. 

The 6809 compiler will generate direct addressing instructions for any object known by the com- 
piler to be located within the address range OOH and OFFH. For the following C variable 
declaration: 

$ORG = 20H$ 
int FLAG; 
int INFORMATION; 

$END_ORG$ 

the 6809 compiler will generate direct addressing instructions to access variables FLAG and 
INFORMATION, since their addresses are known by the compiler to be between OOH and OFFH. 
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Program initialization and Exit 



The routine "entry", which gets loaded if the $ENTRY$ directive is ON and the function "main" is 
declared, appears as follows: 



"6809" 

EXTERNAL MAIN 
ENTRY 

LDS #STACK_ 

LDX #0 

PSHS X 

LBSR MAIN 

LBSR Z_END_PROGRAM 
EENTRY EQU $-1 

GLOBAL EENTRY 

GLOBAL ENTRY 

EXTERNAL Z_END_PROGRAM 

EXTERNAL STACK 

END ENTRY 



"6809" 

EXTERNAL main 
Entry 

LDS #STACK- 

LDX #0 

PSHS X 

LBSR main 

LBSR Z_END_PROGRAM 
entry EQU Ent ryOO_D+OOOOOH 
EntryOOD 

RMB 00002H 
EEntry EQU $-1 

GLOBAL EEntry 

GLOBAL Entry 

GLOBAL entry 

EXTERNAL E_END_PROGRAM 

EXTERNAL STACK_ 
END Entry 



NOTE 

If the $UPPER_KEYS$ directive was ON, the routine ENTRY will call 
MAIN. 
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Stack Pointer Initialization 



The stack pointer is a hardware register maintained by the processor. Prior to use, however, it 
must be initialized by the user. A program that has a main code section must generate the follow- 
ing stack initialization statements in the relocatable file: 

EXT STACK_ 
LDS #STACK_ 

Since the EXT statement implies that the label STACK_ has been declared global (GLB) by another 
program module, the compiler will build a relocatable file, leaving assignment of the STACK_ value 
for the linker. 

If the label STACK has not been declared global by any program module, the linker will search 
the applicable library for a default value. Depending upon which library has been selected by the 
user, one of the following default values will be selected: 

a. If the DLIB_6809:C6809 library is linked, the stack will 
be assigned 512 bytes in the program (PROG) area of the 
linked modules. 

b. If the LIB_6809:C6809 library is linked, the stack will 
be assigned 512 bytes in the data (DATA) area of the 
linked modules. 



NOTE 

Whenever the LIB 6809:C6809 library is linked, a DATA area location 
must be specified. 



The user should allocate a larger stack when necessary. In particular, recursive programming will 
generally require a much larger stack than static programming to run properly. 

Another approach to stack pointer initialization is to define a global variable called STACK_ as 
shown in the following example: 



(file M0DULE1 :source) 



$ORG 3F80H$ 

Short STACK_AREA [127]; 

Short STACK 

SEND ORGS 
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The compiler will generate relocatable code which sets the stack pointer to the address of STACK- 
(4000H in this example), and use an area of 129 bytes (3F80H..4000H) for the stack. 

The use of an absolute address for the stack as in the above example has the user convenience of 
assigning a fixed block of memory for the stack. It may be better, however, to allow the compiler 
to actually preserve a relocatable data area for the stack by leaving out the $ORG$ and 
$END_ORG$ options. This will help prevent accidental reuse of the assigned stack area by 
another module. 



An approach when linking assembly language files is to include the initial stack pointer value or a 
stack area in an assembly file such as: 



"6809" 

GLB STACK_ . 
STACK_ EQU 2000H ;puts initial stack 

; pointer at 2000H 



or: 



"6809" 



STACKBOT 
STACK : 



GLB STACK_ . 
DATA 

RMB <stacksize> 
RMB 1 



puts stack 
storage in the 
DATA area of 
the program 



Note that the address of STACK will receive the first data byte being pushed. This file may then 
be linked with the other program modules generated by the compiler as follows: 

Object files: ASMF I LE 1 , MODULE 1 , M0DULE2 

After stack initialization the routine "main" is called. On return, a jump to Z_END_PROGRAM is 
done. 

If the $ENTRY$ directive was turned OFF, the user is responsible for initialization. 
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Stack Format During Program Execution 

Integer values are pushed on the stack: low byte, high byte, and popped: high_byte,low_byte. 

Execution of PSHS X: 

Stack before execution: 

< (S) 

Stack after execution: 



Lowbyte of (X) 

High byte of (X) < (S) 



Execution of PULS X: 

Stack before execution: 



Low_byte of (X) 

High_byte of (X) < (S) 



Stack after execution: 



(S) 



When any recursive routine is entered in the 6809 compiler, the library routine RENTRY_ or 
VRENTRY_ (variable number of parameters) is called. RENTRY_ or VRENTRY_ will allocate the 
routine's data area and will copy and arrange the parameters. In addition, it will create the neces- 
sary static links. 
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The following sample program illustrates some principles of stack organization: 



1 "C" 

2 "6809" 

3 SRECURSIVE OFF$ /*NOTE: RECURSIVE IS ON BY DEFAULT*/ 
4 

5 Stat 1 c_f unc(p1 ) 

6 i 

7 I'nt p1; 
8 

9 pi = 1; 

10 > 
11 

12 SRECURSIVE 0N$ 
13 

14 recurs i ve_func( pi ) 

15 i 

16 int pi; 
17 

18 pi = 1; 

19 > 
20 

21 littLe_func(p1) 

22 <: 

23 return pi ; 

24 > 

25 

26 struct big_type i 

27 int 11,i2,i3; 

28 >bt1,bt2; 
29 

30 struct big_type big_func(p1) 

31 struct big_type pi; 

32 i 

33 return pi; 

34 > 
35 

36 int i,j; 

37 

38 main ( ) 

39 <: 

40 Stat i c_f unc( i ) ; 

41 recurs i ve_func( i ) ; 

42 i = 1 1 tt le_f unc( j ); 

43 btl = big_func(bt2); 

44 > 
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When executing line 9, the stack appears as follows: 

Return address to main <— Stack Pointer 

NOTE 

There is no data area on the stack because static_func is a static 
procedure. 

When executing line 18, the stack appears as follows: 

return address to main 

recursive func's Parameters 

No. of parameter bytes 

recursive func's Data <— Stack Pointer 

When executing line 23, the stack appears as follows: 

Return address to main 
big-func's Parameters 
No. of parameter bytes <— Stack Pointer 

When executing line 33, the stack appears as follows: 
Return address to main 
big_func's Parameters 

Address of bt1 
No. of parameter bytes <— Stack Pointer 

Note that for big tunc, the address of the result (bt1) is passed since it is greater than two bytes. 
For little_func, the address of the result (i) is not passed as the size is only two bytes and the result 
is returned to a register. 
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Recursive Routines - Calling and Returning Sequences 

Fixed Number of Parameters. The calling sequence for a recursive routine with a fixed number of 
parameters is as follows: 

If the parameters are passed in the registers (see PARAM_), 
the calling sequence will be: 

LDrl par#1 
LDr2 par#2 

LDrn par#n 

LBSR recei vi ngrout i ne 

and the receiving routine will push the parameters when it 
is entered, and then call RENTRY_. 

If the parameters are not passed in registers, the calling 
sequence is as follows: 

LDrl par#1 
LDr2 par#2 



LDrX par#x 

PSHS r1,r2,r3,...rX,PC 

LDr1 par#x+1 
LDr2 par#x+2 

LDrX par#n 

PSHS r1,r2,r3, . . . rX 

LBSR recei vi ngrout i ne 

and the receiving routine will only call RENTRY_. 

When returning from RENTRY_, the stack format at exit will be as follows: 

RA(calling routine) 

Par.'s 

Var.'s 

Static Links 

(S) 

The returning sequence is as follows: 

LEAS var_area_size+par_area_size+lever2,S 
RTS 
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Variable Number of Parameters, The parameters are never passed in registers for a variable num- 
ber of parameters call. The calling sequence is: 

LDrl par#1 
LDr2 par#2 



LDrx par#x 

PSHS r1,r2,...,rx 

LDrl par#x+1 

LDr2 par#x+2 



LDrx-1 par#n 

LDrx #no_of_par_bytes 

PSHS r1,r2,...,rx 

LBSR receiving routine 

LEAS no_of_par_bytes+2, S 

The receiving routine will only call VRENTRY_. When returning from VRENTRY_, the stack ap- 
pears as follows: 

Parameters 

No. of parameter bytes 

Variables 

<--(S) 



Interrupt Vector Handling 



The run-time programming environment of C/64000 programs on the 6809 processor has been 
designed to impose a minimum amount of constraints on the user. As a result the code produced 
by the compiler is safely interruptable as long as the interrupt driven process restores the registers 
(which have been automatically pushed onto the stack when the 6809 recognized the interrupt) 
with a return from interrupt (RTI) instruction. 

The 6809 processor supports four types of interrupts: a reset (or powerup) interrupt, a non- 
maskable interrupt, a maskable interrupt, and a software interrupt. The first three of these are en- 
abled by external control signals to the processor, while the last one is enabled by software 
program control. When the processor detects one of these interrupts it saves the current status of 
the processor and jumps to the address in the interrupt vector for that type of interrupt. These 
vectors are in the last 13 bytes of memory. 
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For the rest of this discussion assume that the following assembly module defines the interrupt 
vectors. 



FILE: IRQ:C6809 HEWLETT-PACKARD: 6809 Assembler 

LOCATION OBJECT CODE LINE SOURCE LINE 

1 "6809" 

2 NAME "Interrupt Vector Definition" 

3 

4 EXT S0FT_INT_3, S0FT_INT_2, S0FT_INT_1 

5 EXT FIRQ_INT, IRQ INT, NMIINT, RESTART_INT 
6 

7 ORG 0FFF2H 
8 

FFF2 0000 9 FDB S0FT_INT_3 
10 

FFF4 0000 11 FDB S0FT_INT_2 
12 

FFF6 0000 13 FDB FIRQ_INT 
14 

FFF8 0000 15 FDB IRQINT 
16 

FFFA 0000 17 FDB S0FT_INT_1 
18 

FFFC 0000 19 FDB NMI_INT 

20 

FFFE 0000 21 FDB RESTART_INT 
Errors= 0 



The C/64000 ENTRY program may logically be used as the RESTARTJNT to be called on 
RESTART interrupt. A main program initializes the run time environment for C program execution 
and ends with the jump to a tight loop at Z END PROGRAM (generated by the compiler), thus fit- 
ting all the requirements of the RESTART_INT routine. 

C/64000 allows the user to define procedures as routines to be called in the interrupt vector by 
using the $INTERRUPT 0N$ option. The $INTERRUPT$ option is only recognized for procedures 
defined at the outer block of a program. An interrupt procedure needs to be declared global so its 
address can be available at link time to load the proper interrupt vector. Nothing special is done 
upon entry to the $INTERRUPT$ procedure. At the end of the procedure the compiler generates a 
return from interrupt (RTI) instruction instead of a return from subroutine instruction (RTS). An 
$INTERRUPT$ procedure may not be called like a normal C/64000 procedure because of the RTI 
return instruction. 
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The interrupt procedure can have no parameters but it may be compiled in either the $RECURSIVE 
ON$ or $RECURSIVE OFF$ modes. The $RECURSIVE ON$ mode is required if it is possible to be 
processing multiple interrupts at the same time. 

Any special treatment of interrupts would require some assembly language modules since instruc- 
tions associated with interrupts are not available in C (SYNC, CWAI, ORCC, ANDCC). 

With the previously defined interrupt vector definition the user should compile procedures 
IRQ INT, NMI INT, and SOFTJNT with the $INTERRUPT ON$ option enabled. Care must be 
taken to turn off this option explicitly. 



USER DEFINED OPERATORS 



General 



c/64000 allows the user to define his own special operators (user defined operators). User defined 
operators are created by using the option: $USER_DEFINED$ during the declaration of a user 
type. The option will apply to the declaration of one user type. 

For user defined operators, the compiler will not generate in-line code to perform the operations, 
instead, it will generate calls to user provided run-time routines. The run-time routine names will be 
a composite of the user's type name and the operation being performed: 
TYPENAME OPERATION. The first eleven characters of the user's type name are concatenated 
with an underscore and three characters identifying the operation. 
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Operations 



The following is a list of operators that can be user defined and the run-time routine names that 
the compiler will create when the operations are used on a user type: 



Operation 

1. Add 

2. Negate 

3. Subtract 

4. Multiply 

5. Divide 

6. Modulus 

7. Equal Comparison 

8. Not Equal Comparison 

9. Less Than or Equal 

to Comparison 

10. Greater Than or Equal 

to Comparison 

11. Less Than Comparison 

12. Greater Than Comparison 



Symbol 
+ 



/ 
% 

! = 

<= 

>= 

< 
> 



Run-time Routine 

<typename>_ADD 

<typename>_NEG 

<typename>_SUB 

<typename>_MUL 

<typename>_DIV 

<typename>_MOD 

<typename>_EQU 

<typename>_NEQ 

<typename>_LEQ 

<typename>_GEQ 

<typename>_LES 
<typename>_GTR 



The compiler will provide the user with a Store routine. The 6809 compiler will use the multi-byte 
move routine (MBmove). 
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Parameters 



The parameters are passed to a routine by reference, i.e., the addresses of the parameters are 
passed. For the 6809, the parameters are passed in the following registers: 

Input: D contains the address of the first parameter 
X contains the address of the second parameter 
Y contains the address of the third parameter 

Output: The result should be assigned through register Y 

Register Y will not be defined for relational operations. The result should be assigned to register B, 
and the Z flag in register CC should be set according to the following: 

TRUE - B set to 1, Z flag is set 

FALSE - B set to 0, Z flag is reset 

Register U will not be defined for the unary operation Negate; register X will contain the result. 

The routines for 6809 user-defined operators can be written in C; routines can be either static or 
recursive. 

To use C procedures with user_defined operators, the option $FIXED_PARAMETERS$ should be 
used. 

Example: 

$FIXED_PARAMETERS 0N$ 

USER_MUL (OPERANDI, 0PERAND2, RESULT) 
USER ^OPERANDI, *0PERAND2, *RESULT; 
SFIXED PARAMETERS OFF$ 

The routines for binary operators can be defined in two ways: (1) a procedure with 3 VAR para- 
meters: argumenti, argument2, and result, or (2) as a function with 2 parameters (defined as the 
first two parameters in case 1) and the result being the function result. Argumenti always cor- 
responds to the left-hand side operand and argument2 to the right-hand side operand as follows: 



result = argumenti OPERATOR argument2 
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The unary operator Negate routine can be defined as a procedure with two VAR parameters, or as 
a function with one parameter. The first parameter is the argument and the result is either the 
second parameter or the function result. 

Finally, the routines for relational operators should be defined as functions with two VAR para- 
meters: argumenti and argument2 and a result of type boolean. Care should be taken to assure 
that the Z flag is set to the correct value. This may be accomplished by making certain that the last 
thing the function does is to assign the function result. 



Example: 

The following program defines and uses the user type "MATRIX": 



1 0000 0 



2 
3 
4 
5 
6 
7 
+ 
8 
9 
10 
11 
12 
13 
14 
15 
16 



0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 



EXTERNAL mati 
EXTERNAL mat2 
EXTERNAL mat3 
EXTERNAL flag 
EXTERNAL entry 
"6809" 

SRECURSIVE OFF$ 
#define MAXSIZE 5 
$USER_DEFINED$ 
struct { 

I'nt mat [MAXSIZE] [MAXSIZE] ; /*max i" mum size*/ 

1 nt mat [ 5] [ 5] ; 

short nrows, ncolumns; /*actual size*/ 

> typedef MATRIX; /*user defined MATRIX*/ 

extern MATRIX mat 1 , mat2 , mat3; /*extern causes names 

to appear in Listing*/ 

extern int flag; 
main( ) 



0000 
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17 0000 1 mati = mat2 + mat3 * mati; 

0000 LDX #mat1 

0003 LDY #main01_D 

0007 LDD #mat3 

OOOA LBSR MATRIX_MUL 

OOOD LDX #main01_D 

0010 LDY #mat1 

0014 LDD #mat2 

0017 LBSR MATRIX_ADD 

18 001 A 1 if (mati == mat2) mati = mat2; 

001A LDX #mat2 

001D LDD #mat1 

0020 LBSR MATRIXEQU 

0023 LBEQ mainOI Li 

0027 LDX #mat2 

002A LDU #mat1 

002D LDD #00034H 

0030 LBSR MBmove 

19 0033 1 flag = mati != mat2; 

0033 main01_L1 

0033 LDX #mat2 

0036 LDD #mat1 

0039 LBSR MATRIX_NEQ 
003C CLRA 

003D STD flag 

20 0040 1 

0040 RTS 

0041 main01_D 

0041 RMB 00034H 

0041 Emain EQU $-1 

0041 

0041 GLOBAL Emain 
0041 

EXTERNAL MATRIXADD 
EXTERNAL MATRIX_MUL 
EXTERNAL MATRIXEQU 
EXTERNAL MATRIX_NEQ 
GLOBAL main 
EXTERNAL MBmove 
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OPTIONS 

OPTIMIZE 
Default OFF. 



Forward Branches - The 6809 has short branch instructions that can be used when the location to 
be branched to is within 128 bytes from the branch location. The compiler optimizes all backward 
branches since it knows the distance to be branched to at compile time. Forward branches, on 
the other hand, are always assumed to be long (the distance to be branched to is not known). 
Since most forward branches have been found to be short, an optimization has been added to the 
6809 compiler such that when the option $OPTIMIZE$ is ON, the compiler assumes that all for- 
ward branches are short. This will cause a compiler error (Pass 3 ERROR-- 1200) if the branch 
happens to be out of range; if this occurs, $OPTIMIZE$ should be turned OFF around the branch 
where the error occurs. The error reads: Long range error, turn off OPTIMIZE for this line. 

Recursive Parameter Addressing - The 6809 has three different stack offset sizes: 5 bits, 8 bits, 
and 16 bits. The parameters on a recursive routine are always allocated on the stack and their 
stack offsets will depend on the number and size of the variables and temporaries used in the 
routine. Since the stack offset size for the parameters is not known until the end of the routine, all 
stack offsets for recursive parameters are assumed to be 16 bits long. When the option 
$OPTIMIZE$ is ON, however, the compiler makes an "educated guess" on the size of the parame- 
ter stack offset. This can cause a compiler error if the actual offset size does not match the com- 
pilers guess, and the compiler program counter will differ from the actual program counter. The 
error will appear on the next label following the statement where the parameter is accessed. When 
this error occurs, turn OPTIMIZE OFF at least for the statement where the parameter is accessed. 
The error has a rippling effect, so it is recommended that $OPTIMIZE$ be turned OFF for the entire 
routine. The error reads: Program counters do not agree. 



DEBUG 
Default OFF. 



The DEBUG option is used to check for arithmetic errors on arithmetic operations for the standard 
types. Operations which may normally be performed with in-line code (such as a BYTE add), will 
be performed using a subroutine call if the $DEBUG$ option is ON. The library routines in the 
debug library have checks to detect arithmetic errors. The routines of the same name in the non- 
debug libraries perform the same arithmetic operation but do not detect any error conditions. 
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FIXEDPARAMETERS 
Default OFF. 



This option allows the user to define a routine with a fixed number of parameters. This definition is 
necessary when interacting with Pascal programs. With variable number of parameters, the para- 
meters are never passed in registers and an extra parameter, indicating the number of parameter 
bytes, is required. There is an extra overhead for clearing the parameters from the stack at the call- 
ing end instead of at the receiving end. 



POSITION INDEPENDENT CODE 



Parts of the 6809 compiler are not position independent. 

Switch-statements have position-dependent code (absolute jump). This can be avoided by writing 
if-statements instead of switch-statements. 



Addressing of Constants 



Some addresses and dope vectors are allocated in a constant data area with the label 
"CONST_prog". Possible cases that require constants are: the use of the function, multi- 
dimensional or integer element array references, pointers, user-defined constants, etc. Compile 
your program with options expand and check the assembly code for the label "CONST_prog'' to 
verify that the compiler has used the constant area. The constant area is always allocated at the 
end of the main program. 



Addressing of Static Variables and Temporaries 



A program with no static variables and all procedures being recursive will not have this problem. 



External Procedures 



Any external procedure requires an address (determined by the linker); this includes the run-time 
routines. 



2-17 



C/64000 Compiler Supplement 6809 
C/64000 Programming 6809 



PASS 2 AND PASS 3 ERRORS 



Pass 2 and 3 errors will be displayed on the screen with the message: 

LINE # <line number>-PASS2 ERROR # <error number> 
or LINE # <line number>-PASS3 ERROR # <error number> 

In addition, if a listing file has been indicated for the compilation it will indicate pass 2 and 3 errors 
where they occurred. It will also give you a listing of the meaning of each error. 

Pass 2 and 3 error numbers will always be >=1000. Errors with numbers between 1000 and 1099 
are fatal errors. Errors with numbers >=1100 are non-fatal errors. 

Pass 2 and 3 will stop generating code after a fatal pass 2 or 3 error. If a listing file has been indi- 
cated for the compilation, pass 3 will give you a listing with errors. Non-fatal errors are output to 
the display and to the listing file (if one exists), but compilation continues after appropriate action 
has been taken to correct the error. A list of pass 2 and 3 errors is given in Table 2-1 . 



Table 2-1. 6809 Pass 2 And Pass 3 Errors 

1000 - "Out of memory" 

The 6809 code generator has run out of memory, break up your 
program and recompile. 

1001 - "Size not implemented" 

An integer larger than 16 bits has been detected. 

1002 - "Size error" 

A size larger than the maximum size allowed for a type has 
been detected. 

1003 - "Type not implemented" 

A real or other unimplemented type has been detected. 

1004 - "Type error" 

An operation with an incorrect type of operands has been 
detected; for example, a negation of an unsigned value. 

1005 - "Unimplemented feature" 

An attempt has been made at using a feature not implemented 
on the 6809 code generator. 

1006 - "Compiler error. Contact Hewlett-Packard" 

This is a compiler level error. Please report this error to 
Hewlett-Packard as soon as possible. 
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Table 2-1- 6809 Pass 2 And Pass 3 Errors (Cont'd) 

1007 - "Expression too complicated" 

The compiler can not handle the level of complexity of this 
expression, simplify your expression. 

1008 - "Register needed but not available" 

The compiler can not generate more code without additional 
registers; add temporary results for your operations. 

1010 - "Too many constants" 
More than 256 constant values required during code 
generation. Eliminate duplicate real constants or break 
up module and recompile. 

1103 - "Interrupt procedure must not have parameters" 

An interrupt procedure can not have parameters. The compiler 
will ignore the parameters and continue to generate code. 

1104 - "Interrupt procedure call not allowed" 

An interrupt routine can only be accessed through an interrupt 
vector, since it will return with an RTI instead of an RTS. 
The compiler will ignore calls to interrupt routines. 

1106 - "Program counter overflow" 

The program will wrap around OFFFFH. Other errors may occur 
if this is not corrected. 

1107 - "Data counter overflow" 

The data counter will wrap around OFFFFH. 

1110 - "Defined a static routine within a recursive one" 
Static routines can not be defined within recursive routines 
because of the difference in addressing. The compiler makes 
the routine recursive and continues to generate code. 

1111 - "Interrupt routines must be at level one" 

All interrupt routines must be at level one. For routines 
defined at levels greater than 1 with $INTERRUPT 0N$, the 
compiler will ignore the option, i.e. it will generate a 
non-interrupt routine. 

1113 - "Program counters do not agree" 
The program counter for a label generated by Pass 2 does not 
agree with the program counter for that label in Pass 3. 
Please report the error to Hewlett-Packard as soon as 
possible. This error is detected in Pass 3. 

1200 - "Lonq range error; turn off OPTIMIZE for this line" 
The option $OPTIMIZE$ causes the code generator to use 2-byte 
branch instructions for forward branches. This error occurs when 
the label is too far away. Turning $OPTIMIZE OFF$ for this line 
of code will produce a long jump which will always work. 
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NOTES 
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Chapter 3 



RUN-TIME LIBRARY SPECIFICATIONS 



General 



This chapter describes the run-time library routines available in the C/64000 compiler library for the 
6809 microprocessor. Each routine description includes the purpose, input requirements, and 
output results. 

The library is logically divided into two groups of routines. One group contains the standard library 
procedures and functions. The second group supplies the elementary routines that supplement 
the standard 6809 instruction set. Tables 3-1 and 3-2 list the standard and supplemental routines 
for the 6809 microprocessor. 



NOTE 



Some of the libraries listed In the tables will never be accessed by the "C" 
compiler but are available In the run-time library for the user. 



Table 3-1. Library Routines (Standard) 



Name 



Purpose 



Ref 
Page 



DISPOSE 
MARK 



ARRAY_ 

PARAM_ 

VPARAM_ 

RENTRY_ 

VRENTRY 



INITHEAP 
NEW 



RELEASE 



Compute address of array element 3-6 

Pass parameters to procedures 3-14 

Pass variable parameters to procedures 3-16 

Recursive procedure entry 3-11 

Recursive procedure entry 3-13 

Declares block of memory as memory pool 3-10 

Dynamic memory allocation 3-10 

Dynamic memory deallocation 3-10 

Save current status of dynamic memory heap 3-10 

Restore prior status of dynamic memory heap 3-10 
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Table 3-2. Library Routines (for 6809) 
8-bit Arithmetic Group 



Ref 

Name Purpose Page 



Zbyteabs Byte absolute value 3-18 

Zbyteneg Byte negation 3-18 

Zbyteadd Byte addition 3-18 

Zubyteadd Unsigned byte addition 3-19 

Zbytesub Byte subtraction 3-19 

Zubytesub Unsigned byte subtraction 3-19 

Zbytemul Byte multiplication 3-19 

Zbytediv Byte division 3-18 

Zubytediv Unsigned byte division 3-19 

16-Bit Arithmetic Group 



Ref 

Name Purpose Page 



Zintadd Integer addition 3-20 

Zuintadd Unsigned integer addition 3-21 

Zintsub Integer subtraction 3-21 

Zuintsub Unsigned integer subtraction 3-22 

Zintmul Integer multipl ication 3-21 

Zuintmul Unsigned integer multipl ication 3-22 

Zintdiv Integer division 3-21 

Zuintdiv Unsigned integer division 3-21 

Byte and Word Shifts 



Ref 

Name Purpose Page 



Zbshift Byte shift logical with zero fill 3-23 

Zbrotate Byte shift circular 3-23 

Zwshift Word shift logical with zero fill 3-23 

Zwrotate Word shift circular 3-23 
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Table 3-2. Library Routines (for 6809)(Cont'd) 
Byte and Word Set Operations 



Ref 



Name 


Purpose 


Page 


Lu 1 1 1 be LO 


R\/1'D in R-hi't" cot" 
Dy Lc III OUIL bcL 




Zbinsetie 


Byte in 16-bit set 


3-25 


ZbtosetS 


Byte to 8-bit set 


3-24 


Zbtosetie 


Byte to 16-bit set 


3-25 


Zwinsetie 


Word in 16-bit set 


3-26 


Zwtosetl6 


Word to 16-bit set 


3-26 




Multi-byte Operations 








Ref 


Name 


Purpose 


Page 


MBmove 


Multi-byte assignment 


3-27 


MBequ 


Multi-byte equality test 


3-27 


MBneq 


Multi-byte inequality test 


3-27 


MBgeq 


Multi-byte greater than or 


3-27 




equal test 




MBgtr 


Multi-byte greater than test 


3-27 


MBleq 


Multi-byte less than or equal 


3-27 




test 




MBles 


Multi-byte less than test 


3-27 



Multi-byte Set Operations 



Name 




Purpose 




Ref 
Page 


INSETmb 


Multi 


-byte set 


incl usion 


3-29 


TOSETmb 


Multi 


-byte set 


formation 


3-29 


SETmbINT 


Multi 


-byte set 


intersection 


3-29 


SETmbUNI 


Multi 


-byte set 


union 


3-29 


SETmbDIF 


Multi 


-byte set 


difference 


3-30 




or 


equal 






SETmbLEQ 


Multi 


-byte set 


less than 


3-30 




or 


equal 
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Table 3-2. Library Routines (6809)(Cont'd) 

Byte and Integer Comparison and 
Bounds Checking Routines 



Ref 



Name 


Purpose 


Page 


Zee 


Carry cleared test 


3-32 


Zequ 


Byte and integer equality test 


3-32 


Zneq 


Byte and integer inequality test 


3-32 


Zgeq 


Byte and integer greater than 


3-32 




or equal test 




Zgtr 


Byte and integer greater 


3-32 




than test 






Byte and integer less than 


3-32 




or equal test 




Zles 


Byte and integer less than test 


3-32 


Zugeq 


Unsigned byte and integer greater 3-32 




than or equal test 




Zugtr 


Unsigned byte and integer greater 3-32 




than test 




Zuleq 


Unsigned byte and integer less 


3-32 




than or equal test 




Zules 


Unsigned byte and integer less 


3-32 




than test 




Zbbounds 


Byte bounds checking 


3-33 


Zubbounds 


Unsigned byte bounds checking 


3-33 


Zwbounds 


Integer bounds checking 


3-33 


Zuwbounds 


Unsigned integer bounds checking 


3-33 
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Table 3-2. Library Routines (for 6809)(Cont'd) 
String Operations 







Ref 


Name 


Purpose 


Page 


STmove 


String assignment 


3-36 


STequ 


String equal i ty test 


3-34 


STneq 


String inequality test 


3-34 


STgeq 


String greater than or 


3-34 




equal test 




STgtr 


String greater than test 


3-34 


STleq 


String less than or equal test 


3-34 


STIes 


String less than test 


3-34 


CHequ 


String-char equality test 


3-34 


CHneq 


oiring-cnar inequality lesx 


'5 '5/1 


CHgeq 


String-char greater than or 


3-34 




equa i les l 




CHgtr 


String-char greater than test 


3-34 


CH1eq 


String-char less than or 


3-34 




equal test 




CH1es 


String-char less than test 
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Miscellaneous 




Name 


Purpose 




FND DATA 


Label at the end of the library that can 




be used to allocate the HEAP area. 


Z_END_PROGRAM 


Label called at the end of the main program. 


EMPTY_SET_ 


The largest possible empty set for the 6809. 


STACK_ 


Label for stack 




COMPB_ 


Compares bytes, called by the 


compari son 




routines. 




TRUE_ 


Returns a true result (1) in 


register (B) and 




resets the Z flag. Called by the comparison 




routines. 




FALSE_ 


Returns a false result (0) in 


register (B) and 




sets the Z flag. Called by the comparison 




routines . 




MASTER 


Memory allocation global 
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ARRAY REFERENCE ROUTINES 



The C/64000 compiler supports generalized array references with up to 10 indices. The array 
reference routine is called with the parameters: 

DOPEVECTOR - address of a record describing the array, 

BASEADDRESS - address of the first element of the 

array. (May be indirected like a VAR 
parameter. ) 

Index_list - addresses of the actual index expressions 
(one for each formal index expression). 

The array reference routine return the computed memory address to the X register. 



ARRAY_ 

The ARRAY_ routine returns the memory address of an n-dimensional array reference expression. 
The array reference call for the 3-index array variable expression: 

A[I][J][7] 

would be: 

LDU baseaddress ; base address of array A 

LDY I 

LDX J 

PSHS U,Y,X 

LDU #0007H 

PSHS U 

LDA #3 ; number of indices passed 

LDX dopevectoraddress ; for array A 
LBSR ARRAY_ 

To illustrate the use of indirection required for the base address, consider variable B defined as a 
pointer to an array of the same type as A in the above example. A reference to an element of B 
with the variable array expression: 

*B[6+Y][J][7] 

would generate a call to ARRAY_ in the form: 
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LDD Y 
ADDD #0006H 

LDU [B] ; base address of array A 

TFR D,Y 

LDX J 

PSHS U,Y,X 

LDU #0007H 

PSHS U 

LDA #3 ; number of indices passed 

LDX dope_vector_address ; for array A 

LBSR ARRAY 

Multi-dimensioned arrays are simply defined as array of arrays. An array may be referred to in its 
entirety (a so-called ENTIRE variable) by referring to the array by its name using no parameters. A 
variable expression allows the user to refer to an INDEXED element type by allowing from 1 to N 
index expressions to be used in an array reference. C arrays are stored such that the rightmost 
subscript changes faster. 

The ARRAY_ call for a two-indexed array variable expression with a 3-dimensional array A is as 
follows: 

A[I][J] 

For example: 

LDU baseaddress ; base address of array A 

LDY I 
LDX J 
PSHS U,Y,X 

LDA #2 ; number of indices passed 

LDA dopevectoraddress ; for array A 
LBSR ARRAY_ 

The formulae for computing array element addresses are as follows: 

a. The formula used to compute the array element address is: 

ADDRESS: BASE ADDRESS + (-OFFSET CONSTANT) + 
(11 * PROD I) + (12 * PR0D_2) +...+ 
(IN * PROD N) 

b. The (-OFFSET CONSTANT) term is the product of the index 
lower bounds and the row widths, i.e., 

(ML * PROD I) + (I2L * PR0D_2) +...+ 
(INL * PROD N) 
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c. The expression used to compute the array row reference 
using N-1 index expression is: 

row address := BASE ADDRESS + (-OFFSET CONSTANT) 
" + (11 * PR0D_^1) +...+ 
(lnMINUS_1 * lnMINUS_1) + ROWnMINUS_1 

NOTE 

The addition of ROWnMINUS I takes you to ROWn. 



Generalized Array DOPE VECTOR 



The form of the general array reference dope vector is equivalent to: 

DOPEVECTOR FOB N ;number of 

; dimensions 

FOB (-OFFSETCONSTANT) ;negative of 

; constant 

FOB PRODI 
FDB PRODJ 

FDB PROD_N 
FDB ROWl 
FDB R0W2 

FDB ROWnMINUSJ 

About the Routine: 

At termination, this routine returns the stack pointer to the location it held at the beginning of the 
program. 

The array reference routines return the computed memory address in the X register. 

NOTE 

Users who write assembly language programs that define and use multi- 
dimension arrays to be used with the ARRAY_ routine need to ensure 
that their use is consistent with the 0 compiler. In order to accomplish 
this, it is recommended that the user write a simple C program defining 
and using the arrays. The user can then use the expanded listing file or 
the $ASM FILE$ option to determine how the 0 compiler accesses these 
arrays and defines the array dope vectors. It is important that the user's 
array dope vector be identical to that produced by the compiler. 
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DYNAMIC MEMORY ALLOCATION 



C/64000 supports dynamic allocation and deallocation of storage space through the procedures 
NEW, DISPOSE, MARK, RELEASE, and INITHEAP. These routines must be declared external in 
the C program. 

NOTE 

These routines; NEW, DISPOSE, MARK, RELEASE, and INITHEAP, are static and should be 
defined with $RECURSIVE OFF$. 



INITHEAP 



The user declares a block of memory to be used as the memory pool or heap by calling: 
INITHEAP (Start_address, Lengthjn_bytes). The resultant heap will be six bytes smaller than 
lengthinbytes. 



NEW 



The procedure NEW (Pointer) is used to allocate space. The procedure, NEW, searches for avail- 
able space in a free-list of ascending size blocks. When a block is found that is the proper size or 
larger, it is allocated and any space left over is returned to the free-list in a new place correspond- 
ing to the size of the leftover block. If the referenced block is four or less bytes in size, four bytes 
will be allocated. 



DISPOSE 



The procedure DISPOSE is exactly the reverse of the procedure NEW. It indicates that storage oc- 
cuppied by the indicated variable is no longer required. 



MARK 



This procedure marks the state of the heap in the designated variable that may be of any pointer 
type. The variable must not be subsequently altered by assignment. 

RELEASE 



The procedure RELEASE restores the state of the heap to the value in the indicated variable. This 
will have the effect of disposing all heap objects created by the NEW procedure since the variable 
was marked. The variable must contain a value returned by a previous call to MARK; this value 
may not have been passed previously as a parameter to RELEASE. 
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RECURSIVE ENTRY 



C/64000 supports recursive and reentrant calling sequences for procedures compiled for the 6809 
by additional run-time entry code. This code causes the local data area of a procedure to be allo- 
cated onto the stack before entry to the procedure and to be deallocated from the stack upon exit 
from the procedure. These functions are performed by the procedures RENTRY /VRENTRY_. 



RENTRY 



RENTRY is called at the entry point of a procedure or function which has been declared with the 
option $RECURSIVE ON$. RENTRY_. will copy the parameters, set the static links, and allocate 
the variable size area. 

RENTRY_ is called upon entry to a recursive C procedure or function. The calling sequence is: 

LDU varareasize 

LDA #level ;a1ways <=16 

LDB #register_paranieters_flag ; true (1) or 

; false (0) 

LDX parareasize 



The stack format at entry to RENTRY_ is one of the following: 

With no parameters: 

RA (calling routine) 

RA from RENTRY_ 

< (S) 

With parameters passed in the registers: 



RA (calling routine) 
Par. #n 



Par. #1 
RA from RENTRY_ 

(S) 
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With parameters passed on the stack: 

Garbage 
Par. #n 

Par. #1 
RA(calling routine) 
RA from RENTRY_ 

(S) 

Procedure: 

a. Copy the calling routine's RA to "Garbage" if necessary. 

b. Allocate variables area. 

c. Store the static links. 

The stack format at exit from RENTRY_ is as follows: 
RA(calling routine) 
Par.'s 

Var.'s 

Static Links 

(S) 

All registers but CC are modified. 
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VRENTRY 



VRENTRY is called at the entry point of a recursive procedure or function with variable number of 
parameters (i.e. FIXED PARAMETERS not ON). VRENTRY_ will allocate the variable size area. 

VRENTRY_ is called upon entry to a recursive C procedure or function. The calling sequence is: 



LDD var area size 
LBSR VRENTRY 



The stack format at entry to RENTRY_ is one of the following: 
With no parameters: 
RA (calling routine) 
RA from RENTRY_ 

(S) 

With parameters: 
Par. #n 



Par. #1 
No. of parameter bytes 
RA(calling routine) 
RA from RENTRY 



(S) 



The stack format at exit from RENTRY_ is as follows: 
Par.'s 
RA (calling routine) 
Var.'s 

< (S) 
All registers but CC are modified. 
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Parameter Passer (PARAM ) 



The parameter passer is called from a static routine receiving parameters where the parameters are 
not passed in registers. PARAM_ transfers the parameters from the stack to the called routine's 
static data area. 

If the total par-area-size in a static routine is less or equal to eight bytes and there are not more 
than two parameters of size equal to one byte, then the parameters will be passed in registers (in- 
stead of on the stack), else all the parameters will be pushed on the stack. 

A receiving routine where parameters are passed in the registers has to store or push (for recursive 
routines) every parameter in the receiving routine's data area. 

Calling sequence (from the routine passing the parameters, to the routine receiving the parameters) 
for parameters not passed in registers: 

a. Calling a recursive routine: 

LDr1 par#1 
LDr2 par#2 



LDrX par#x 
PSHS r1,r2,r3,...rX,PC 
LDr1 par#x+1 
LDr2 par#x+2 



LDrX par#n 

PSHS r1,r2,r3 rX 

LBSR receiving_routine 



3-13 



C/64000 Compiler Supplement 6809 
Run-Time Library Specifications 



b. Calling a static routine: 

LDr1 par#1 
LDr2 par#2 



LDrX par#x 

PSHS r1,r2,r3,...,rX 

LDr1 par#x+1 

LDr2 par#x+2 



LDrX par#n 
PSHS r1,r2,r3,...,rX 
LBSR receiving_routine 



Calling sequence (from a static routine receiving the parameters, to PARAM_): 



LDX to address 

LDD par_area_size 
LBSR PARAM 



Stack format at entry to PARAM_: 



Par. #n 



Par. #1 

RA (calling routine) 

RA (receiving routine) 

< (S) 



Stack format at exit from PARAM : 



RA (calling routine) 

< (S) 
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NOTE 

Users who write assembly language programs that define and use 
procedures and functions, particularly with parameters, need to ensure 
that their use is consistent with the C compiler. In order to accomplish 
this, it is recommended that the user write a simple C program defining 
the procedure or function with the desired parameter list and an empty 
program block for code. The user can then use the expanded listing file 
or the $ASM FILES option to determine how the C compiler enters and 
exists the equivalent do-nothing procedure and how the parameters are 
passed. It is important that the user's assembly language routines follow 
the same entry, parameter passing, and exit code produced by the com- 
piler. In particular, it is important that recursive or static mode declara- 
tions (and use) be consistent. 



VPARAM 



The variable parameter passer is the same as PARAM_ except that it includes an extra parameter 
that indicates the number of parameter bytes passed. 

Calling a recursive routine: 



LDr1 par#1 
LDr2 par#2 



LDrX par#x 
PSHS r1,r2,r3,...,rX 
LDr1 par#x+1 
LDr2 par#x+2 



LDrx-1 par#n 

LDrx #no_of_par_bytes 

PSHS r1,r2,r3,...,rx 

LBSR receiving_routine 
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The calling sequence (from a static routine ... VPARAM ): 



LDX to address 
LBSR VPARAM 



The stack format at entry to VPARAM_ is as follows: 



Par #n 



Par #1 
No. of Parameter bytes 
RA (calling) 
RA (receiving) 

< (S) 

The stack format at exit from VPARAM is as follows: 



Par #n 



Par #1 

No. of parameter bytes 

RA (calling routine) 

< (S) 
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STANDARD BYTE ROUTINES 



For standard byte routines, parameter values are passed using specific registers. The operands are 
8-bit signed or unsigned bytes. There are two groups of byte operations: the unary byte operation, 
and the binary byte operation. These operations are discussed in the following paragraphs. 



Unary Byte Operations 



Zbyteabs Byte absolute value 
Zbyteneg Byte negation 



Register Allocation Summary :: Unary byte operations 

Input: B contains value to be operated on 

Output: B contains the result byte 

Registers: 
Modified: B 

Unchanged: A,X,Y,U,S,CC 



Binary Byte Operations 



Zbyteadd 

Zubyteadd 

Zbytesub 

Zubytesub 

Zbytemul 

Zbytedi v 

Zubytedi V 



Byte addition 
Unsigned byte addition 
Byte subtraction 
Unsigned byte subtraction 
Byte mul tipl ication 
Byte division 
Unsigned byte division 



a. Zbyteadd performs the addition of two bytes. 



b. Zbytediv performs the division of two bytes using the following algorithm: 



(1) Shift divisor left to its highest possible value. 



(2) Subtract divisor from dividend. 
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(3) If result is positive, put 1 in rightmost digit of quotient. If negative, add divisor back into 
dividend and put 0 in quotient. 

(4) Shift divisor right and repeat steps 2 and 3 until divisor returns to its original value. The 
result of the division is available in register B upon completion. The remainder is also 
available in register A (used for MODULUS). 

c. Zbytemul performs the multiplication of two bytes. The actual multiplication works on posi- 
tive values and produces a positive dummy result. The routine handles negative operands by 
counting and complementing the negative operands using a counter which is set to -1. If one 
negative operand exists, the counter equals zero and causes the negation of the dummy 
result to obtain the correct result. If both operands are positive or negative, the positive 
dummy result is the actual result. The eight LSB of the result of the multiplication are avail- 
able in register B upon completion of the routine and the eight MSB are in register A. 

d. Zbytesub performs the subtraction of two bytes. 

e. Zubyteadd performs the addition of two unsigned bytes. 

f. Zubytediv performs the division of two unsigned bytes. The binary division algorithm is as 
that of b above. The result of the division is available in register B upon completion. The 
remainder is also available in register A (used for MODULUS). 

g. Zubytesub performs the subtraction of two unsigned bytes. 

Register Allocation Summary :: Binary 8BIT ops. 

Input: B contains the first operand A contains the second operand 

Output: B contains the result A contains the MSB of result - MUL contains the remainder 
- DIV 

Registers: Modified: A,B Unchanged: X,Y,U,S,CC 
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STANDARD INTEGER ROUTINES 



The integer operations require 16-bit operands. The two 8-bit accumulators are normally used as a 
16-bit register (called D) for these routines. As a register pair, the high-order byte is always stored 
in register A and the low-order byte is stored in register B. Register X is a 16-bit register and is 
used for binary operations and for returning some results. There are two groups of integer opera- 
tions: the unary integer operation and the binary integer operation. These operations are discussed 
in the following paragraphs. 



Unary Integer Operations 



Register Allocation Summary :: Unary integer operations 

Input: D contains integer value to be operated on 

Output: D contains integer RESULT 

Registers: 
Modified: D 

Unchanged: X,Y,U,S,CC 
Binary Integer Operations 



Zintabs 
Zintneg 



Integer absolute value 
Integer negation 



Zintadd 
Zuintadd 
Zintsub 
Zuintsub 
Zintmul 
Zuintmul 
Zintdi V 
Zuintdi V 



Integer addition 
Unsigned integer addition 
Integer subtraction 
Unsigned integer subtraction 
Integer multiplication 
Unsigned integer multiplication 
Integer division 
Unsigned integer division 



a. Zintadd performs the addition of two integers. 
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b. Zintdiv performs the division of two integers. The actual division works on positive 
values and produces a positive dummy result. The routine handles negative operands 
by counting and complementing the negative operands using a counter which is set to 
-1. If one negative operand exists, the counter equals zero and causes the negation of 
the dummy result. If both operands are positive or negative, the dummy result is the 
correct answer. The division algorithm is as follows: 

(1) Shift divisor left to Its highest possible value. 

(2) Subtract divisor from dividend. 

(3) If result is positive, put 1 in rightmost digit of quotient. If negative, recover 
divisor before subtraction and put 0 in quotient. 

(4) Shift divisor right and repeat steps b and c until divisor returns to its original 
value. 

The result of the division is available in register D upon completion. The remainder is 
available in register X (used for MODULUS). 

c. Zintmul performs the multiplication of two integers. The actual multiplication works on 
positive values and produces a positive dummy result. The routine handles negative 
operands by counting and complementing the negative operands using a counter 
which is set to -1. If one negative operand exists, the counter equals zero and causes 
the negation of the dummy result. If both operands are positive or negative, the posi- 
tive dummy result is the correct result. The multiplication occurs as follows: 

(A:B) * (C:D) = BDH : BDL + BCH: BCL + ADH: ADL + ACH: 

ACL 

The lower 16 bits of the result are placed into the D register and the 16 most significant 
bits of the result are placed in register X upon completion of the library routine. 

d. Zintsub performs the subtraction of two integers. 

e. Zuintadd performs the addition of two unsigned integers. 

f. Zuintdiv performs the division of two unsigned integers. The binary division algorithm 
is as that in b above. The result of the division is available in register D upon comple- 
tion. The remainder is available in register X (for MOD). 

g. Zuintmul performs the multiplication of two unsigned integers. The actual multiplica- 
tion occurs as explained in c above. The lower 16 bits of the result are placed into 
register D and the 16 most significant bits of the result are placed in register X upon 
completion of the library routine. 

h. Zuintsub performs the subtraction of two unsigned integers. 

Register Allocation Summary :: Binary 16BIT ops. 

Input: X contains the first operand D contains the second operand Output: 
D contains the result X contains the MSW of result - MUL contains 
the remainder - DIV 
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Registers: Modified: D,X Unchanged: Y,U,S,CC 



BYTE AND WORD SHIFTS 



C/64000 supports logical shifting. Circular shifting may be accomplished by calling the run-time 
library ROTATE. The DIV operator using powers of 2 may be used to accomplish an arithmetic 
right shift (i.e., with sign extension). For example, X DIV 2 is equivalent to a one bit right shift with 
sign extension. 



SHIFT 



Logical shifting with zero fill will shift the quantity left or right placing a zero in the most (right shift) 
or least (left shift) significant bit for each shift. The function is called with two parameters: the 
quantity to be shifted and the number of bit positions to shift. 



ROTATE 



Circular shifting rotates the quantity left or right and fills the vacated position with the bit shifted 
out of the other end. The function is called with two parameters: the quantity to be shifted and the 
number of bit positions to shift. 

The type of result returned by the function SHIFT or ROTATE is the same type as the type of the 
first parameter expression. 
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Byte Shifts 



Zbshift 
Zbrotate 



Byte shift logical with zero fill 
Byte shift circular 



The byte shift operations compute the byte result of shift expressions. 

Register Allocation Summary :: Byte shift operations 

Input: A contains byte to be shifted, B1 

B contains number of positions to shift, B2 

Output: B contains the result byte 

Registers: 

Modified: B,CC 
Unchanged: A,X,Y,U,S,DP 

Word Shifts 



Register Allocation Summary :: Integer shift operations 

Input: X contains word to be shifted, 11 

B contains the number of positions to shift, 12 

Output: D contains the result word 

Registers: 
Modified: D 
Unchanged: X,Y,U,S,DP 



Zwshift 
Zwrotate 



Word shift logical with zero fill 
Word shift circular 
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BYTE AND WORD SET OPERATIONS 



Byte Set Operations 



ZbinsetS Byte in 8-bit set 
Zbtoset8 Byte to 8-bit set 



Zbinset8. This routine is used to test the set membership of a byte value in a specified byte set. 

Register Allocation Summary :: ZbinsetS 

Input: B contains the byte set being compared 
A contains byte value to be tested 

Output: B set to 0, Z flag set if value not in set 
B set to 1 , Z flag reset if value in set 

Registers: 

Modified: B,CC 
Unchanged: A,X,Y,U,S,DP 



At termination, register A will contain the byteset which 
was compared. 



ZbtosetS. This routine converts a byte into an 8-bit set. The only valid input values are 0 through 
7. Out of range values are detected in the debug library, DLIB_6809:C6809, but are not detected 
in LIB_6809:C6809 and may produce out of range results. 



Register Allocation Summary :: Zbtoset8 

Input: B contains byte value to be converted 

Output: B contains the byteset result 

Registers: 
Modified: B 

Unchanged: A,X,Y,U,S,CC 
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Word Set Operations 



Zbinsetl6 
Zbtosetl5 
Zwinsetl6 
Zwtosetl6 



Byte in 16-bit set 
Byte to 16-bit set 
Word in 16-bit set 
Word to 16-bit set 



Zbinset16. This routine is used to test the set membership of a byte value in a specified word set. 



Register Allocation Summary :: ZbinsetIG 

Input: B contains byte value to be tested 

X contains the word set being compared 

Output: B set to 0, Z flag set if value not in set 
B set to 1 , Z flag reset if value in set 

Registers: 

Modified: B,CC 
Unchanged: A,X,Y,U,S,DP 



At termination, register X will contain the word set 
compared. 



Zbtoset16. This routine converts a byte into a 16-bit set. The only valid input values are 0 through 
15. Out of range values are detected in the debug library, DLIB_6809:C6809, but are not detected 
in LIB_6809:C6809 and may produce out of range results. 



Register Allocation Summary :: Zbtoset16 

Input: B contains byte value to be converted 

Output: D contains the wordset result 

Registers: 
Modified: D 
Unchanged: X,Y,U,S,CC 
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Zwinset16. This routine is used to test the set membership of a word value in a specified word set. 



Register Allocation Summary :: Zwinset16 

Input: D contains word value to be tested 

X contains the word set being compared 

Output: B set to 0, Z flag set if value not in set 
B set to 1 , Z flag reset If value in set 

Registers: 

Modified: D,CC 
Unchanged: X,Y,U,S,DP 

Zwtoset16. This routine converts a word into a 16-bit set. The only valid input values are 0 
through 15. Out of range values are detected in the debug library, DLIB_6809:C6809, but are not 
detected in LIB_6809:C6809 and may produce out of range results. 

Register Allocation Summary :: Zwtoset16 

Input: D contains word value to be converted 

Output: D contains the wordset result 

Registers: 
Modified: D 

Unchanged: X,Y,U,S,CG 



MULTI-BYTE OPERATIONS 



The multi-byte routines are used by the compiler to operate on multi-byte records (or arrays) of the 
same type. 
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MBmove 



The routine MBmove is used for moving multi byte records such as in an assignment of a com- 
plete record type or an array type to another of the same type. 



Register Allocation Summary :: MBmove 

Input: X contains the first record's addr. 
U contains the second records's addr. 
D contains the number of bytes in 
the records. 

Registers: 
Modified : D 
Unchanged: X,Y,U,S,CC 



Multi-byte Comparisons 



MBequ Multi-byte equality test 

MBneq Multi-byte inequality test 

MBgeq Multi-byte greater than or equal test 

MBgtr Multi-byte greater than test 

MBleq Multi-byte less than or equal test 

MBles Multi-byte less than test 



MBequ. This routine is used by the compiler to test multi-byte records of the same type for 
equality. 

MBneq. This routine is used by the compiler to test multi-byte records of the same type for 
inequality. 

MBgeq. This routine is used by the compiler to test if one set of records is greater than or equal to 
another set of records of the same type. The test is unsigned. 

MBgtr. This routine is used by the compiler to test if one set of multi-byte records is greater than 
another set of the same type. The test is unsigned. 

MBleq. This routine is used by the compiler to test if one set of records is less than or equal to 
another set of records of the same type. The test is unsigned. 

MBles. This routine is used by the compiler to test if one set of records is less than another set of 
records of the same type. The test is unsigned. 
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A compare routine is called to compare the bytes and upon re-entry to this program, a branch is 
taken to either a "true" or "false" routine. 



Register Allocation Summary :: Multi-bytes 

Input: X contains the first record's addr. 
U contains the second records's addr. 
D contains the number of bytes in 
the records. 

Registers: 
Modified : D 
Unchanged: X,Y,U,S,CC 



Output: 

test results B register Z flag 



true 1 reset 

false 0 set 

Additionally, register A will contain the byte within the first set of bytes which caused the equality 
comparison to fail or was the last equal byte to be compared. 



MULTI-BYTE SET OPERATIONS 



Sets requiring three or more bytes, are referred to as multi-byte sets. 



Multi-byte Set Routines 



INSETmb 


MuUi 


TOSETmb 


Mu1ti 


SETmblNT 


Multi 


SETmbUNI 


Multi 


SETmbDIF 


Multi 


SETmbLEQ 


Multi 



byte set inclusion 
byte set formation 
byte set intersection 
byte set union 
byte set difference 
byte subset inclusion 
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INSETmb. This routine is used to test the set membership of an integer value in a multi-byte set. 



Register Allocation Summary :: INSETmb 

Input : X contains address of the multi-byte 
set 

D contains the integer value V 

Output: IF V is contained in set 
THEN 

B set to 1 (TRUE), Z flag reset 
ELSE 

B set to 0 (FALSE), Z flag set 

Registers: 

Modified : D,CC 
Unchanged: X,Y,U,S,DP 



TOSETmb. This routine is used to convert a value into a multi-byte set. 



Register Allocation Summary :: TOSETmb 

Input: X contains byte value to be converted 
U contains the addr. of the result set 
D contains the number of bytes in the 
set 

Registers: 
Modified: D 
Unchanged: X,Y,U,S,CC 



SETmblNT. This routine is used to compute the set intersection of two multi-byte sets. 



SETmbUNL This routine is used to compute the set union of two multi-byte sets. 
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SETmbDIF. This routine is used to compute the set difference of two multi-byte sets. The set dif- 
ference is a set containing all the elements of the multi-byte set in (X) which are not contained in 
the multi-byte set in (U). 



Register Allocation Summary :: Big sets 

Input : X contains the first set's adr. 
U contains the second set's adr. 
Y contains the result set's adr. 
D contains the number of bytes 

Registers: 
Modified : D 

Unchanged: X,Y,U,S,CC 



SETmbLEQ. This routine is used to compute the set inclusion of two multi-byte sets. 

Register Allocation Summary :: SETmbLEQ 

Input : X contains address of S1 
U contains address of S2 
D contains the number of bytes 

Output: IF S2 is a subset of S1 
THEN 

B set to 1 (TRUE), Z flag reset 
ELSE 

B set to 0 (FALSE), Z flag set 

Registers: 

Modified : D,CC 
Unchanged: X,Y,U,S 



To accomplish the "proper subset" operation, the 6809 compiler will invert the operands and 
proceed to call SETmbLEQ. 



3-29 



C/64000 Compiler Supplement 6809 
Run-Time Library Specifications 



BYTE AND INTEGER COMPARISON AND BOUNDS 
Checking Routines 



The comparison (=,<>,>=,>,<=,<) of byte and integer variables produces a Boolean result (FALSE or 
TRUE) based on the signed or unsigned sequences of byte or word scalar types. In many cases 
where the comparison is being used as the condition for an IF, REPEAT, or WHILE statement, a 
branch is taken based on the result of the comparison. However, if the Boolean result is being as- 
signed to a variable or if the expression has multiple comparisons (using AND and OR) an actual 
Boolean result is required. The byte and word comparison subroutines are used specifically in 
these situations were the Boolean result is necessary for further computations. 



Byte and Word Comparisons 



Zee Carry clear test 

Zequ Byte and integer equality test 

Zneq Byte and integer inequality test 

Zgeq Byte and integer greater than or equal test 

Zgtr Byte and integer greater than test 

Zleq Byte and integer less than or equal test 

Zles Byte and integer less than test 

Zugeq Unsigned byte and integer greater than or 
equal test 

Zugtr Unsigned byte and integer greater than test 

Zuleq Unsigned byte and integer less than or equal 

test 

Zules Unsigned byte and integer less than test 
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Library subroutines are called when the Boolean result is required of a comparison expression of 
the following form: 11 .op. 12 

Zee is called to test if the carry bit is cleared. 

Zequ is called to test for equality between 11 and 12 by testing if the Z flag of the condition 
codes is set. 

Zneq is called to test for inequality between II and 12 by testing if the Z bit of the condition 
codes is set. 

Zgeq is called to test if II is greater than or equal to 12 by testing if either, but not both, of the N 
or V bits of the condition codes is set. 

Zgtr is called to test if II is greater than 12 by testing if the "EXCLUSIVE OR " of the N and V 
bits is 1 or Z=1. 

Zleq is called to test if II is less than or equal to 12 by testing if the "EXCLUSIVE OR" of the N 
and V bits is 1 or Z=1. 

Zles is called to test if either, but not both, of the N or V bits is set. 

Zugeq is called to test if II is less than 12 by testing if the C flag of the condition codes is set. 

Zugtr is called to test if II is greater than 12 by testing if the previous operation caused either a 
carry or a zero result. 

Zuleq is called to test if II is less than or equal to 12 by testing If the previous operation caused 
either a carry or a zero result. 

Zules is called to test if the C bit is set or not. 



Output: 



test results 



B register 



Z flag 



true 
fal se 



1 
0 



reset 
set 
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Byte Bounds Checking 



Zbbounds Byte bounds checking 
Zubbounds Unsigned byte bounds checking 



The bounds checking forlsigned and unsigned byte variables use the same calling sequence and 
return the same results. The value being checked is loaded into register X. The upper limit is 
loaded into register A and the lower limit is loaded into register B. Upon return, register B contains 
the Boolean result (FALSE or TRUE) of the bounds check and the Z flag will be set according to 
the Boolean value in B. If B=FALSE (0) then Z is set. If B=TRUE (1) then Z is reset. 



Register Allocation Summary :: Byte bounds check 

Input: B contains the value V 

MSB of X contains the lower limit (LL) 

LSB of X contains the upper limit (UL) 

Output: B set to 0, Z flag set if value not in range 

B set to 1, Z flag reset if value in range 

Regi sters : 

Modified: B,CC 
Unchanged: X,Y,U,S 



Word Bounds Checking 



Zwbounds Integer bounds checking 
Zuwbounds Unsigned integer bounds checking 



The bounds checking for signed and unsigned word variables use the same calling sequence and 
return the same results. The value being checked is loaded into register X. The upper limit is 
loaded into register D and the lower limit is loaded into register U. Upon return, register B contains 
the Boolean results (FALSE or TRUE) of the bounds check and the Z flag will be set according to 
the Boolean value of register B. If B=FALSE then Z is set. If B=TRUE than Z is reset. 
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The logic of the routine is: 



IF UL <= V <= LL THEN trueresult 

ELSE falseresult 

Register Allocation Summary :: Word bounds check 

Input: D contains the upper limit (UL) 
U contains the lower limit (LL) 
X contains the value V 



Output: B set to 0, Z flag set if value not in range 
B set to 1, Z flag reset if value in range 



Registers: 

Modified: B,CC 
Unchanged: X,Y,U,S 



STRINGS AND CHARACTERS 



The routines STequ, STneq, STgeq, STgtr, STIeq, STIes are used by the compiler to test strings 
equality or inequality. 

The routines CHequ, CHneq, CHgeq, CHgtr, CHIeq, CHIes are used by the compiler to test strings 
.vs. characters equality or inequality. The character is always the first argument (the compiler will 
invert the relational operand if necessary, i.e. ST <= CH becomes CH > ST). This routines will set 
up their arguments and then call the string routines. 

A compare routine is called to compare the bytes and upon re-entry to this program, a branch is 
taken to either a "true" or "false" routine. 

String equality and inequality in the C compiler are determined by the following rules: 

a. Two strings are equal IF their lengths are equal and they are equal character by character. 

b. The inequality of two strings is determined by the first character by which they differ and if all 
characters are equal then the longest string is the largest. 
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Register Allocation Summary: String routines 

Input : X contains the first string's addr. 
U contains the second string's addr. 
D contains the number of bytes in 
the string's type 

Registers: 
Modified : D 

Unchanged: X,Y,U,S,CC 



Register Allocation Summary: Character routines 

Input : B contains the character (first operand) 
U contains the string's address 
D contains the number of bytes in the 
string's type 

Registers: 
Modified : D 
Unchanged: X,Y,U,S,CC 



Output: 

test results B register Z flag 



true 1 reset 

false 0 set 



Additionally, register A will contain the byte within the first set of bytes which caused the equality 
comparison to fail or was the last equal byte to be compared. 



STmove 

The routine STmove is used to copy a string from one location to another. 

Register Allocation Summary :: STmove 

Input: X contains the first string's addr. 
U contains the second string's addr. 
D contains the number of bytes in the 
first string's type (n1+1) 

Registers: 
Modified : D 

Unchanged: X,Y,U,S,CC 



3-34 



Chapter 4 

RUN-TIME LIBRARY 
SPECIFICATIONS FOR REAL NUMBERS 

REAL NUMBER LIBRARIES 



The C/64000 implementation of the IEEE floating point standard for the 6809 microprocessor is 
supported by the real library: RealLIB:C6809 (for C data types: "double" and "float"). Table 4-1 
summarizes the standard C floating point routines. These routines use the parameter passing 
conventions described for normal C static functions with the option $FIXED_PARAMETERS OFFS 
($FIXED_PARAMETERS OFF$ is the default; see Chapter 2 "Options"). 



Table 4-1. C Real Number Library Routines 
($FIXED_PARAMETERS OFF$) 



Ref 



Name 


Purpose 


Page 


ABS 


Double absolute value 


4-3 


SQRT 


Double square root 


4-3 


EXP 


Double exponentiation(e to the X) 


4-3 


LN 


Double natural logarithm 


4-3 


SIN 


Double sine 


4-3 


COS 


Double cosine 


4-3 


ARCTAN 


Double arctangent 


4-3 



Table 4-2 summarizes the rest of the floating point routines supported by the C/64000 real number 
library. These routines use the parameter passing method obtained with the compiler option 
$FIXED_PARAMETERS 0N$. 



The parameter passing for these routines is that described in User Defined Operators" (see 
Chapter 2). Each library routine has an external interface using a global symbol in the form: 
REAL op or LONGREAL op, where op is the mnemonic for one of the supported operations. 
Since the compiler performs some automatic type conversions there are some additional opera- 
tions to convert between "int", "float" and "double" data types. Each of the library routines is 
defined by the equivalent C procedure heading for its declaration. 
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Table 4-2. C Real Number Library Routines 
($FIXED_PARAMETERS 0N$) 



Ref 

Name Purpose Page 



REAL_ADD Real addition 4-4 

REALSUB Real subtraction 4-4 

REAL_MUL Real multiplication 4-4 

REAL DIV Real division 4-4 

REArABS Real absolute value 4-5 

REALNEG Real negation 4-5 

REAL_SQRT Real square root 4-5 

REALEXP Real exponentiation(e to the X) 4-5 

REALLN Real natural logarithm 4-5 

REAL_SIN Real sine 4-5 

REAL_COS Real cosine 4-5 

REAL_ATAN Real arctangent 4-5 

REALEQU Real equality test 4-6 

REAL_^NEQ Real inequality test 4-6 

REAL LES Real less than test 4-6 

REALGTR Real greater than test 4-6 

REAL LEQ Real less than or equal test 4-6 

REAL_GEQ Real greater than or equal test 4-6 

REALFLOAT Integer to real conversion 4-7 

REAL_ROUND Real to integer conversion with rounding 4-7 

REALTRUNC Real to integer conversion with truncation 4-7 

LONGREALADD Longreal addition 4-4 

LONGREALSUB Longreal subtraction 4-4 

LONGREALMUL Longreal multiplication 4-4 

LONGREALDIV Longreal division 4-4 

LONGREAL_ABS Longreal absolute value 4-5 

LONGREALNEG Longreal negation 4-5 

LONGREAL_SQRT Longreal square root 4-5 

LONGREALEXP Longreal exponentiation(e to the X) 4-5 

LONGREALLN Longreal natural logarithm 4-5 

LONGREALSIN Longreal sine 4-5 

LONGREAL_COS Longreal cosine 4-5 

LONGREALATAN Longreal arctangent 4-5 

LONGREALEQU Longreal equality test 4-6 

LONGREALNEQ Longreal inequality test 4-6 

LONGREALLES Longreal less than test 4-5 

LONGREALGTR Longreal greater than test 4-6 

LONGREALjLEQ Longreal less than or equal test 4-6 

LONGREAL_GEQ Longreal greater than or equal test 4-6 

LONGREAL FLOAT Integer to longreal conversion 4-7 

LONGREALROUND Longreal to integer conversion with rounding 4-7 

LONGREALTRUNC Longreal to integer conversion with trucation 4-7 

REALCONTRACT Longreal to real conversion 4-7 

REALEXTEND Real to longreal conversion 4-7 
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C REAL NUMBER LIBRARY ROUTINES 
($FIXED PARAMETERS OFF$) 
NOTE 

The routines in this section, use the parameter passing method that is 
generated with the default option $FIXED_PARAMETERS OFF$. 



The unary functions using the standard C compatible method for passing parameters 
($FIXED_PARAMETERS OFF$) supported in the library, RealLIB:C6809, are as follows: 



double ABS { ARGUMENT 


) 


/* 


double absolute value */ 


double ARGUMENT; 




double NEG ( ARGUMENT 


) 


/* 


double negation */ 


double ARGUMENT; 






double SQRT ( ARGUMENT 


) 


/* 


double square root */ 


double ARGUMENT; 






double EXP ( ARGUMENT 


) 


/* 


double exponentiation */ 


double ARGUMENT; 








double LN ( ARGUMENT 


) 


/* 


double natural logarithm */ 


double ARGUMENT; 




double SIN ( ARGUMENT 


) 


/* 


double sine(radians) */ 


double ARGUMENT; 


double COS ( ARGUMENT 


) 


/* 


double cosine(radians) */ 


double ARGUMENT; 






double ARCTAN ( ARGUMENT ) 


/* 


double arctangent */ 


double ARGUMENT; 









C REAL NUMBER LIBRARY ROUTINES 
($FIXED_PARAMETERS 0N$) 



NOTE 



The routines in this section use the parameter passing method generated 
with the option $FIXED_PARAI\/1ETERS 0N$. 
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FLOATING POINT BINARY OPERATIONS 



For binary floating point operations of the form: 

RESULT = LEFT <op> RIGHT; 

the equivalent C procedure heading is in the form: 

REAL <op> ( LEFT,RIGHT,RESULT ) float *LEFT,*RIGHT,*RESULT; or LONGREAL_<op> ( 
LEFT,RIGHT,RESULT ) double *LEFT,*RIQHT,*RESULT; 



The binary operations supported in RealLIB:C6809 are as follows: 



REALADD ( LEFT, RIGHT, RESULT ) /* float addition */ 

float *LEFT,*RIGHT,*RESULT; 
REALSUB ( LEFT, RIGHT, RESULT ) /* float subtraction */ 

float *LEFT,*RIGHT,*RESULT; 
REALMUL ( LEFT, RIGHT, RESULT ) /* float multiplication 
V 

float *LEFT,*RIGHT,*RESULT; 
REAL DIV ( LEFT, RIGHT, RESULT ) /* float division */ 

float *LEFT,*RIGHT,*RESULT; 
LONGREALADD { LEFT, RIGHT, RESULT )/* double addition */ 

double *LEFT,*RIGHT,*RESULT; 
LONGREALJUB ( LEFT, RIGHT, RESULT )/* double subtraction */ 

double *LEFT,*RIGHT,*RESULT; 
LONGREAL MUL { LEFT, RIGHT, RESULT )/* double multiplication 
V 

double *LEFT,*RIGHT,*RESULT; 
LONGREALDIV ( LEFT, RIGHT, RESULT )/* double division */ 
double *LEFT,*RIGHT,*RESULT; 
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FLOATING POINT UNARY OPERATIONS 



For unary floating point operations of tfie form: 

RESULT = <op> RIGHT; 

the equivalent C procedure fieading is in tfie form: 

REAL_<op> ( RIGHT.RESULT ) float *RIQHT,*RESULT; or LONGREAL_<op> ( RIGHT.RESULT 
) double *RIGHT,*RESULT; 

The unary operations supported in RealLIB:C6809 are as follows: 



REAL_ABS ( RIGHT, RESULT ) 
V 

float BRIGHT, *RESULT; 
REAL NEG ( RIGHT, RESULT ) 

float *RIGHT,*RESULT; 
REALSQRT { RIGHT, RESULT ) 

float *RIGHT,*RESULT; 
REALEXP ( RIGHT, RESULT ) 
V 

float *RIGHT,*RESULT; 
REALLN ( RIGHT, RESULT ) 
logarithm*/ 

float *RIGHT,*RESULT; 
REAL SIN { RIGHT, RESULT ) 

float *RIGHT,*RESULT; 
REAL COS { RIGHT, RESULT ) 

float *RIGHT,*RESULT; 
REAL_ATAN ( RIGHT, RESULT ) 

float *RIGHT,*RESULT; 
LONGREALABS ( RIGHT, RESULT ) 

V 

double *RIGHT,*RESULT; 
LONGREAL NEG ( RIGHT, RESULT ) 

double *RIGHT,*RESULT; 
LONGREALSQRT ( RIGHT, RESULT ) 

double *RIGHT,*RESULT; 
LONGREALEXP ( RIGHT, RESULT ) 

V 

double *RIGHT,*RESULT; 
LONGREALLN { RIGHT, RESULT ) 
logarithm */ 

double *RIGHT,*RESULT; 
LONGREALSIN { RIGHT, RESULT ) 

double *RIGHT,*RESULT; 
LONGREAL COS ( RIGHT, RESULT ) 

double *RIGHT,*RESULT; 
LONGREALATAN ( RIGHT, RESULT ) 

double *RIGHT,*RESULT; 



/* float absolute value 

/* float negation */ 
/* float square root */ 
/* float exponentiation 

/* float natural 

/* float sine */ 
/* float cosine */ 
/* float arctangent */ 
/* double absolute value 

/* double negation */ 
/* double square root */ 
/* double exponentiation 

/* double natural 

/* double sine */ 
/* double cosine */ 
/* double arctangent */ 
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FLOATING POINT COMPARISON OPERATIONS 

For floating point comparison operations of the form: 

BOOLEAN = LEFT <op> RIGHT; 

the equivalent C procedure heading is in the form: 

short REAL_<op> ( LEFT.RIGHT ) float *LEFT,*RIGHT; or short LONGREAL_<op> 
LEFT,RIGHT ) double *LEFT,*RIGHT; 

The comparison operations supported in RealLIB:C6809 are as follows: 



*RIGHT; 
LEFT, RIGHT ) 

*RIGHT; 
LEFT, RIGHT ) 

*RIGHT; 
LEFT, RIGHT ) 

BRIGHT; 
LEFT, RIGHT ) 



short REAL EQU ( LEFT, RIGHT ) 

float *LEFT,*RIGHT; 
short REAL NEQ ( LEFT, RIGHT ) 

V 

float *LEFT, 
short REAL LES 

V 

float *LEFT. 
short REAL_GTR 
test V 

float *LEFT. 
short REALLEQ 
equal test */ 

float *LEFT, 
short REALGEQ 
equal test */ 

float *LEFT,*RIGHT; 
short LONGREALEQU ( LEFT, RIGHT ) 

V 

double *LEFT,*RIGHT; 
short LONGREAL NEQ { LEFT, RIGHT ) 

V 

double *LEFT,*RIGHT; 
short LONGREALLES { LEFT, RIGHT ) 

V 

double *LEFT,*RIGHT; 
short LONGREALGTR ( LEFT, RIGHT ) 
test V 

double *LEFT,*RIGHT; 
short LONGREALLEQ ( LEFT, RIGHT ) 
equal test */ 

double *LEFT,*RIGHT; 
short LONGREALGEQ ( LEFT, RIGHT ) 
equal test */ 

double *LEFT,*RIGHT; 



/* float equality test */ 
/* float inequality test 

/* float less than test 

/* float greater than 

/* float less than or 

/* float greater than or 

/* double equality test 

/* double inequality test 

/* double less than test 

/* double greater than 

/* double less than or 

/* double greater than or 
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FLOATING POINT CONVERSION OPERATIONS 



For floating point conversion operations of the form: 

RESULT = <op> RIGHT; 

the equivalent C procedure heading is in the form: 

REAL_<op> ( RIGHT, RESULT ) RIGHTtype *RIGHT; RESULTtype *RESULT; or 
LONGREAL_<op> ( RIGHT, RESULT ) RIGHTtype *RIGHT; RESULTtype 'RESULT; 

The conversion operations supported in RealLIB:C6809 are as follows: 

REALFLOAT { RIGHT, RESULT ) /* convert int to float 

V 

int *RIGHT;float *RESULT; 
REAL ROUND { RIGHT, RESULT ) /* convert float to int 

V 

float *RIGHT; int *RESULT; /* with rounding */ 

REALTRUNC ( RIGHT, RESULT ) /* convert float to int 

V 

float *RIGHT; int *RESULT; /* with trunctation 

V 

LONGREALFLOAT ( RIGHT, RESULT ) /* convert int to double 

V 

int *RIGHT; double *RESULT; 
LONGREALROUND ( RIGHT, RESULT ) /* convert double to int 

V 

double *RIGHT; int ^RESULT; /* with rounding */ 

LONGREALTRUNC ( RIGHT, RESULT ) /* convert double to int 

V 

double *RIGHT; int *RESULT; /* with truncation */ 

REALCONTRACT ( RIGHT, RESULT ) /* convert double to 
float V 
double *RIGHT; float *RESULT; 
REAL_ EXTEND ( RIGHT, RESULT ) /* convert float to 
double V 
float *RIGHT; double *RESULT; 
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FLOATING POINT ERROR DETECTION 



The floating point libraries have two error conditions which when detected cause the execution of 
one of two global routines. These routine names are OVERFLOW and INVALID. OVERFLOW is 
called when an operation would produce an invalid number. INVALID is called when an invalid 
floating point number is passed as a parameter to one of the floating point routines. 

The user may replace either of these routines with an error recovery routine of his own. In par- 
ticular defining either of these routines as a simple return from subroutine instruction (RTS) will 
cause the program to continue with an Invalid number returned as a result. If OVERFLOW or 
INVALID are to be defined in a C program, they must have no parameters with the option 
$FIXED_PARAMETERS ON$. 

If the user does not supply his or her own version of these routines, the libraries will supply one 
which will display a message on the buffer ERROR MESSAGE, and then return to the library 
routine. 

If either of the illegal opcodes is detected by the emulator, the user can get information describing 
the error by entering the emulation command: 



display memory ERROR MESSAGE blocked word 
which will produce a memory display indicating the error condition. 
If no error has occurred, the display will appear as follows: 



Memory iwords iblocked : repet i t i vely 

address data :hex :ascii 



9003 


-12 


4E6F 


2065 


7272 


6F72 


2020 


2020 


2020 


2020 


9013 


-22 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9023 


-32 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9033 


■42 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9043 


■52 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9053 


-62 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9063- 


"72 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9073- 


■82 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9083- 


•92 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


9093- 


■A2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


90A3- 


•B2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


90B3- 


■C2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


90C3- 


■D2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


90D3- 


•E2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


90E3- 


F2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


90F3- 


02 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 



4-8 



C/64000 Compiler Supplement 6809 
Run-Time Library Specifications for Real Numbers 



Memory :words rblocked : repet i t i ve I y 

address data :hex :ascii 



9003 


-12 


5265 


616C 


2020 


2020 


6572 


726F 


7220 


2020 


Real error 


9013 


-22 


494E 


5641 


4C49 


4420 


2020 


2020 


2020 


2020 


INVALID 


9023 


-32 


5245 


414C 


5F41 


4444 


2020 


2020 


2020 


2020 


REAL ADD 


9033 


-42 


726F 


7574 


696E 


6520 


6361 


6C6C 


6564 


2020 


rout i ne ca I I ed 


9043 


-52 


6279 


2020 


2020 


2020 


7573 


o572 


2020 


2020 


by usei' 


9053 


-62 


6672 


6F6D 


2020 


2020 


6164 


64 72 


6573 


7320 


from address 


9063 


-72 


3143 


3137 


482E 


2020 


2020 


2020 


2020 


2020 


1C17H. 


9073 


-82 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




9083 


-92 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




9093 


-A2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90A3 


-B2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90B3 


-C2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90C3 


-D2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90D3 


-E2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90E3 


-F2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90F3 


-02 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




Memory 


:words :blocked : repet i t i ve I y 






address 




data 






: hex 






: a s c i i 


9003- 


■12 


5265 


616C 


2020 


2020 


6572 


726F 


7220 


2020 


Real error 


9013- 


■22 


4F56 


4552 


464C 


4F57 


2020 


2020 


2020 


2020 


OVERFLOW 


9023- 


32 


4C4F 


4E47 


5245 


414C 


5F41 


4444 


2020 


2020 


LONGREAL _ADD 


9033- 


42 


726F 


7574 


696E 


6520 


6361 


6C6C 


6564 


2020 


rout i ne call ed 


9043- 


52 


6279 


2020 


2020 


2020 


7573 


6572 


2020 


2020 


by user 


9063- 


72 


3144 


3535 


482E 


2020 


2020 


2020 


2020 


2020 


from address 


9073- 


82 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


1D55H. 


9083- 


92 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




9093- 


A2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90A3- 


B2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90B3- 


C2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90C3- 


D2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90D3- 


E2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90E3- 


F2 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 




90F3- 


02 


2020 


2020 


2020 


2020 


2020 


2020 


2020 


2020 





From this display the user can tell what type error has been detected, which floating point library 
was called, and where the floating point library detected the error. 
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Appendix A 

RUN-TIME ERROR DESCRIPTIONS 



This appendix contains descriptions of run-time errors that may occur. 



ERROR UTILITIES 



Name 



Purpose 



Derrors Debugging library error handler 

Zerrors Normal library error handler 



Derrors 



□errors contains the run-time routines which store user information at the time an error occurs 
during debugging. The following errors may occur In the indicated library routines: 



Error 
Underflow 



Overflow 



Routines 

Zbytemul ,Zintmul ,Zuintmul 
Zbyteadd, Zubyteadd, Zintadd, 

Zuintadd 
Zbytesub, Zubytesub, Zintsub, 

Zuintsub 

Zbytemul, Zintmul, Zuintmul 
Zbytediv, Zubytediv, Zintdiv, 

Zuintdi V 
Zbyteadd, Zubyteadd, Zintadd, 

Zuintadd 
Zbytesub, Zubytesub, Zintsub, 

Zuintsub 
Zbyteneg, Zintneg 
Zbyteabs, Zintabs 
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Div_by_Zero Zbytediv, Zubytediv, 

Zintdiv, Zuintdiv 

Case error User programs 

Range_error COMPB_ . 

Heaperror INITHEAP, NEW, DISPOSE, MARK, 

RELEASE 

Setconversionerror 

ZbtosetS, ZwtosetS 
Zbtosetie, Zwtosetie 

String_error MOVEST_ . 



When an error is detected, a jump to Derrors is generated and valid register information is saved. 
The labels for the stored information are described below: 



Label 



Description 



ZCALLERH 
Z CALLER L 



Z_CC_FLAGS 
Z_ACC_A 
Z_ACC_B 
Z_REG_X 
Z REG U 



Contain the high byte {CALLER_H) 
and the low byte (CALLERL) of 
the address of the statement which 
called the routine where the 
actual error occurred. 

Contain the contents of the 
registers at the time the error 
occurred. Only registers with 
information relevant to the error 
are saved - the indicated contents 
of the other registers is garbage. 



NOTE 

The CC register which is displayed is that which was present when the 
error occurred in the Debug Library routine. The CC register which was 
present when the Debug routine was called is not retrievable. 
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The following is a description of the errors that may occur and the information that is accessible 
when they do occur. 



Error Msg. 
Available 



Description 



Information 



Z ERR OVERFLOW 



Z ERR UNDERFLOW 



Z ERR DIV BY 0 



Jump to error 
occurs when 
results of 
multipl ication, 
addition, 
subtraction, 
negation, or the 
absolute value 
is too positive 
(i.e. 

INTEGERS: 
result > 32767 

BYTES: 
result > 127) 

Jump to error 
occurs if results 
of addition, 
subtraction, or 
multipl ication 
were too negative 
( i.e. 

INTEGERS 
result < -32768 

BYTES 
result < -128) 

Jump to error 
occurs if division 
by zero is attempted 
by byte or integer 
division routines. 



ZCALLERH 
Z CALLER_L 
zee FLAGS 
Z ACC_A 
Z ACC B 
ZREGX 
Z REG U 



CALLERH 

CALLER_L 

CCFLAGS 

ACC_A 

ACCB 

REGX 

REG U 



ZCALLERH 
Z_CALLER_L 
ZCCFLAGS 
Z REG X 
Z REG U 



Z ERR SET CONV 



Jump to error 
occurs if operand 
is not legal 
ordinal value for 
a set of the base 
type. 



ZCALLERH 

ZCALLERL 

ZCCFLAGS 

Z_ACC_A 

ZACCB 

Z REG X 
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ZERRRANGE Jump to error ZCALLERH 

occurs if a range ZCALLERL 

declaration has Z_CC_FLAGS 

been violated ZACCA 

( i.e.: a variable ZACCB 

does not fall ZREGU 

within its 

assigned range) 



Z ERR HEAP 



Z ERR CASE 



Jump to error 
occurs when some 
misuse of the 
dynamic allocation 
keywords NEW, 
DISPOSE, MARK, or 
RELEASE takes place. 

Jump to error 
occurs when the 
test variable of 
CASE statement is 
out of range and 
no OTHERWISE label 
exi sts . 



Z_CALLER_H 
ZCALLERL 
Z_CC_FLAGS 
? 



Z_CALLER_H 
Z_CALLER_L 
Z_ACC_A 
Z ACC B 



Z ERR STRING 



Z END PROGRAM 



Jump to error Z_CALLER_H 

occurs on a string Z_CALLER_L 

assingment, when 

the run-time size 

of the string being 

assigned is larger 

than that of which 

is it is being 

assigned to. 

Jump to message occurs when the 
program completes execution of the 
main body code. 
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The illegal opcodes associated with the various errors are as follows: 



Opcode Error 

01 Overflow 

02 DivbyO 
05 Caseerror 

14 Range error 

15 Recursi ve_error 
18 Heap error 

38 Set_conversion_error 

41 Underflow 

42 String_size_assignment_error 



Zerrors 



Zerrors contains the run-time routines which store user information at the time an error occurs 
during execution in the non-debug library. The following errors may occur in the indicated library 
routines: 



Error 



Routines 



Case error 

Range_error 

Heaperror 

Stringerror 



User programs 

COMPB_ . 
INITHEAP, NEW, DISPOSE, MARK, 

RELEASE 
MOVES! . 



When an error is detected, a jump to Zerrors is generated and valid register information is saved. 
The stored information, the routines and the illegal opcodes for this errors are as described in 
□errors. 



Z END PROGRAM is also called. 
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Index 



The following index lists important terms and concepts of this manual along with the location(s) 
where they can be found. The numbers to the right of the listings indicate the following manual 
areas: 



o Chapters - References to chapters appear as "Chapter X", where "X" represents the 
chapter number. 

0 Appendices - References to appendices appear as "Appendix Y" where "Y" 
represents the letter designator of the appendix. 

o Figures/Tables - References to figures or tables are represented by the capital letter 
"F" or "T" followed by the appropriate number. 

o Other entries in the index - Other entries in the index have their location indicated 
by page number. 
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